home *** CD-ROM | disk | FTP | other *** search
/ Wildcat Gold - The Optical BBS / Wildcat Gold - The Optical BBS (The Golden ROM Series)(Volume 4 Number 1)(The Digital Publishing Company)(1992).ISO / sdn / psprnt10.sdn / PSPRINT.DOC next >
Text File  |  1991-12-31  |  25KB  |  522 lines
  1.  
  2.                     PSPRINT VERSION 1.0 USER'S GUIDE
  3.  
  4.  
  5.                              Star Graphics
  6.                         6904 Robin Willow Drive
  7.                           Dallas, Texas  75248
  8.  
  9.  
  10. PURPOSE OF PSPRINT
  11.  
  12. This program is designed to print a regular ASCII file on a Postscript
  13. printer.  In so doing, a variety of user defined styles may be used to
  14. prepare the input for printing.  For example, the user may specify that the
  15. input data be printed two-up on a page (that is, print two pages on each
  16. physical page).
  17.  
  18. SHAREWARE CONCEPT
  19.  
  20. PSPRINT is a shareware application that allows the user to print an ASCII
  21. file on a Postscript printer.  Several features enhance the printing such
  22. as allowing the user to print two pages on each piece of paper.  Some of
  23. these features are disabled in the shareware version.  When you register,
  24. you will receive a diskette (specify format, 3 1/2" or 5 1/4") with the
  25. latest version.  A complete copy of the documentation will also be sent.
  26. The serialized disk you will receive will not be copy protected, but it
  27. will be for your own personal use (and is not to be distributed to others).
  28. The shareware version may be distributed unaltered to anyone else and you
  29. are encouraged to upload it to your favorite bulletin board, if it is not
  30. already there.
  31.  
  32. If you find PSPRINT useful and continue to use it after a reasonable trial
  33. period, please make a registration payment of $35.00 (mostly to cover the
  34. cost of mailing you an updated diskette and documentation) to:
  35.  
  36.         Star Graphics
  37.         6904 Robin Willow Drive
  38.         Dallas, Texas 75248
  39.  
  40. The $35.00 registration fee will license one copy for use on any one
  41. computer at any one time.
  42.  
  43. Commercial users of PSPRINT must register and pay for their copies of
  44. PSPRINT within 30 days of first use or their license is withdrawn.
  45.  
  46. Reasonable site licensing arrangements may be made by dropping the author,
  47. Star Graphics, a note at the address above.
  48.  
  49. Anyone distributing PSPRINT for any kind of remuneration must first contact
  50. the author, Star Graphics, at the address above for authorization.  This
  51. authorization will be automatically granted to distributors recognized by
  52. ASP (Association of Shareware Producers) as adhering to its guidelines for
  53. shareware distributors, and such distributors by begin offering PSPRINT
  54. immediately.  However, the author must be advised so that the distributor
  55. can be kept up-to-date with the latest version.
  56.  
  57.  
  58. You are encouraged to pass a copy of PSPRINT along to your friends and
  59. associates for evaluation.  Please enourage them to register their copy if
  60. they find it useful.  All registered users will receive the latest version
  61. of PSPRINT and accompanying documentation.
  62.  
  63.  
  64. LEGALESE
  65.  
  66. Star Graphics does not warrant that the licensed software will meet your
  67. requirements or that the operation of the software will be uninterrupted of
  68. error free.  The warranty does not cover any media and documenation that
  69. has been subjected to damage or abuse by your or others.  The software
  70. warranty does not cover any copy of the licensed software which has been
  71. altered or changed in any way.
  72.  
  73. ANY IMPLIED WARRANTIES INCLUDING ANY WARRANTIES OF MERCHANTABILITY OR
  74. FITNESS FOR A PARTICULAR PURPOSE ARE LIMITED TO THE TERM OF THE EXPRESS
  75. WARRANTIES.  Some states do not allow limitiations on how long an impled
  76. warranty lasts, so the above limitation may not appy to you.
  77.  
  78. The warranties set forth above are in lieu of any and all other express or
  79. implied warranties, whether oral, written, or impled, and the remedies set
  80. forth above are the sole and exclusive remedies.
  81.  
  82. Star Graphics is not repsonsible for any problems or damage caused by the
  83. licensed software that may result from using the licensed software.  This
  84. includes, but is not limited to, computer hardware, computer software,
  85. operating systems, and any computer or computing accessories.  End user
  86. agrees to hold the author harmless for any problems arising from the use of
  87. the software.
  88.  
  89. The author shall not in any case be liable for any special, incidental,
  90. consequential, indirect or other similar damages arising from any breach of
  91. these warranties even if Star Graphics or its agents or distributors have
  92. been advised of the possibility of such damages.
  93.  
  94. In no case shall Star Graphics liability exceed the license fees paid for
  95. the right to use the licensed software.
  96.  
  97.  
  98. BACKGROUND
  99.  
  100. Postscript is a printer control language whose function is not dissimilar
  101. to the languages used by many other printers.  For example, with most
  102. dot-matrix type of printers, if the desired output is compressed at
  103. approximately 15 characters per inch, the program would send a command to
  104. printer in the form of an ESCape character followed by the ASCII number 15.
  105. The ESC-15 combination is an element of the printer control language used
  106. by that printer.  So too, Postscript, is a printer control language, albeit
  107. a very much enhanced one, that was designed for composition of an entire
  108. page.  An example of what the Postscript control language looks like is:
  109.  
  110.  
  111.  
  112.   ╔═════════════════════════════════════════════════════════════════════════╗
  113.   ║       NOTE: These lines are truncated at the left                       ║
  114.   ║                                                                         ║
  115.   ║  32 0 0 50 50 1 0 47 /Helvetica-Bold /font5 ANSIFont font               ║
  116.   ║  300 317 557 (PURPOSE OF PSPRINT) SB                                    ║
  117.   ║  32 0 0 42 42 0 0 38 /Times-Roman /font12 ANSIFont font                 ║
  118.   ║  300 428 1308 (This program is designed to print a regular ASCII file   ║
  119.   ║  32 0 0 50 50 1 0 47 /Helvetica-Bold /font5 ANSIFont font               ║
  120.   ║  300 575 366 (BACKGROUND) SB                                            ║
  121.   ║  32 0 0 42 42 0 0 38 /Times-Roman /font12 ANSIFont font                 ║
  122.   ║  300 686 1773 (Postscript is a printer control language not too disimi  ║
  123.   ║  300 736 1679 (printers.  For example, with most dot-matrix type of pr  ║
  124.   ║  300 786 1735 (approximately 15 characters per inch, the program would  ║
  125.   ║  300 836 1704 (ESCape character followed by the ASCII number 15.  The   ║
  126.   ║  300 886 1735 (printer control language used by that printer.   So tooB ║
  127.   ║  300 936 1752 (very much enhanced one that was designed for compositio  ║
  128.   ║  300 1086 1752 (On the assumption that the printer will be used in in   ║
  129.   ║  300 1136 1160 (had to be found to print a regular ASCII file while it  ║
  130.   ║  300 1336 187 (the printer.) SB                                         ║
  131.   ║  32 0 0 50 50 1 0 47 /Helvetica-Bold /font5 ANSIFont font               ║
  132.   ║  300 1583 525 (SELECTING OPTIONS) SB                                    ║
  133.   ║  32 0 0 42 42 0 0 38 /Times-Roman /font12 ANSIFont font                 ║
  134.   ╚═════════════════════════════════════════════════════════════════════════╝
  135. You can see from the example, that aside from the numbers which generally
  136. represents X and Y coordinates of where data is to print on a page, most of
  137. the commands are readable.  It is easy to see where the font changes.  If
  138. you send ASCII data to the printer without these Postscript commands,
  139. usually nothing will print because the printer will be waiting for the
  140. Postscript commands telling it what to do with the data that was sent.
  141. This is the reason why PSPRINT was written; to wrap the necessary
  142. Postscript commands around the ASCII text in order to allow the Postscript
  143. printer to perform its task.  Generally, many Postscript printers provide
  144. an emulation mode which will allow the printer to emulate an IBM Proprinter
  145. or an Epson printer and in so doing allow it to print non-Postscript ASCII
  146. text; however, in this situation, you generally do not have a wide
  147. selection of fonts and font sizes available with which to perform the
  148. printing.
  149.  
  150. In addition to specifying the font and its size to be used when printing
  151. your ASCII text, PSPRINT allows many other specifications such as printing
  152. pages two-up on a page.
  153.  
  154. SELECTING OPTIONS
  155.  
  156. Many options, described below, are available with PSPRINT.  These options
  157. may be selected in one of four ways, or any combination of the four.  The
  158. parameters may:
  159.  
  160.     *   default to the program defaults
  161.     *   be specified in an "initialization file" whose name defaults to
  162.         PSPRINT.INI (but you are allowed to have as many initialization
  163.         files as necessary for usual stypes of print and can specify which
  164.         file to use).
  165.     *   be specified on the command line invoking PSPRINT
  166.     *   be input via menu selections.
  167.  
  168.  
  169. The easiest way to run PSPRINT is to simply use the program defaults;
  170. however, in the majority of instances changes will be desired.  Changing
  171. parameters is easily accomplished with the simple pull- down menus provided
  172. by PSPRINT.  For more permanent changes, from invocation to invocation,
  173. parameters may be stored in either the default PSPRINT.INI file or in a
  174. user named "initialization file".
  175.  
  176. USING THE PROGRAM DEFAULTS
  177.  
  178.  
  179. If options are not specified in any of the ways discussed above, then the
  180. program defaults will be used.  The program defaults are:
  181.  
  182.    ╔════════════════════════════════════════════════════╗
  183.    ║   Font = Courier                                   ║
  184.    ║   Size = 12 points (there are 72 points per inch)  ║
  185.    ║   Top Margin = .5 inch                             ║
  186.    ║   Bottom Margin = .5 inch                          ║
  187.    ║   Left Margin = .5 inch                            ║
  188.    ║   Lines per inch = 6 LPI                           ║
  189.    ║   Outline = No                                     ║
  190.    ║   Shading = No                                     ║
  191.    ║   Line Width = 1.2                                 ║
  192.    ║   Rotate = 0                                       ║
  193.    ║   Portrait (tall) page orientation                 ║
  194.    ║   Two up printing = No                             ║
  195.    ║   hdrfont = (See text)                             ║
  196.    ║   hdrsize = (See text)                             ║
  197.    ║   header = No                                      ║
  198.    ║   number = Nos                                     ║
  199.    ╚════════════════════════════════════════════════════╝
  200.  
  201.  
  202. USING A PROFILE
  203.  
  204. You may place your most commonly used settings in an initialization file.
  205. The default initialization file is named PSPRINT.INI and you may make your
  206. changes in it, or you may simply build a completely new initialization
  207. file.  The easiest way to build an initialization file is to invoke
  208. PSPRINT, set your options using the pull-down menus, and then select the
  209. option from the File pull-down menu to save the initialization file; this
  210. will prompt for the name to use for the new file.
  211.  
  212. If the first character of any line in the initialization file is an "*" or
  213. a ";", that line is treated as a comment.  Any or all of the parameters may
  214. be placed into the initialization file.  The format of the profile follows
  215. the "Keyword = Operand" format.  As mentioned earlier, you may have
  216. multiple initialization files and specify which one is to be used with a
  217. "/PRO=" parameter either on the command line or specified via the pull-down
  218. menu.  For example, if PSPRINT is started with the following command:
  219.  
  220.          PSPRINT TEST.TXT /PRO=TWOUP.PRO
  221.  
  222. then the file named TEST.TXT will be printed using the specifications in
  223. the initialization file named TWOUP.PRO.
  224.  
  225.  
  226. PSPRINT has the capability to print using some special effects.  You can
  227. print the data with hollow, outlined characters, called "outline" printing.
  228. You can print specifying that you want a shadow emanating from the
  229. characters.  Shading, fixed and variable of the characters may be
  230. specified, or you can choose to print the characters using a "fancy" form
  231. of printing.  The keywords associated with "special effects" are mutually
  232. exlusive.  You may only specify one of the following keywords:
  233.  
  234.         * outline
  235.         * fancyprint
  236.         * dropshadow
  237.         * variableshade
  238.  
  239. If multiple special effect keywords are specified, the program will only
  240. honor the first one encountered.
  241.  
  242. It is not necessarily intended for PSPRINT to print an entire document
  243. using the special effects capability, although it may be done.  Rather the
  244. purpose is to print only a line or two and ideally create an EPS
  245. (Encapsulated Postscript File) from it for importing into a program like
  246. PageMaker.  High on the list of priorities is a modification to the program
  247. that will automatically generate an EPS file but some technical problems
  248. still need to be overcome.  However, in the meantime, if you direct the
  249. output to a file using the "device" keyword with a file extension of
  250. ".EPS", you may easily modify that file by adding a "BoundingBox:"  comment
  251. line as the second line of the file.  For more information on construction
  252. of the "bounding box" comment, you should see a good reference manual on
  253. PostScript.
  254.  
  255. The keywords are:
  256.  
  257.  
  258. KEYWORD
  259. EXPLANATION
  260.  
  261. FONT           Exact font name
  262.  
  263. SIZE           Size of type
  264.  
  265. TOP            Top margin in inches
  266.  
  267. BOT            Bottom margin in inches
  268.  
  269. LEFT           Left margin in inches
  270.  
  271. LPI            Lines per inch
  272.  
  273. OUTLINE        (yes or no)
  274.  
  275. NOMENU         Suppresses display of menus
  276.  
  277. SHADING        "No" or the degree of shading which is a number between 0
  278.                and 1 where 0 is white and 1 is black.  If this parameter
  279.                is included in the profile with anything other than "no"
  280.  
  281.  
  282.  
  283. LW             Width of line for outline characters in points
  284.  
  285. DEVICE         Destination of the output.  This may be a filename, an LPT
  286.                Port, or a pseudo port address such as PSPORT or AES:LPT3.
  287.                If you are printing directly to a printer, you should
  288.                specify whatever address you use to address your Postscript
  289.                printer. Some printer emulations set up "pseudo ports" so
  290.                that, for example, LPT1 could be a ProPrinter, LPT2 a
  291.                Hewlett-Packard Printer, and LPT3 a Postscript printer
  292.                (all, of course, physically attached to LPT1); in this
  293.                instance you would specify LPT3 as the device.  If you
  294.                specify a filename, that file can be printed later by
  295.                copying it to the printer (Eg., COPY MYFILE.TXT LPT3).
  296.  
  297. ORIENT         Specify portrait or landscape printing
  298.  
  299. ROTATE         Rotation of characters on the page.  A plus orientation
  300.                will cause the characters to be rotated counter clockwise
  301.                and a negative rotation will rotate the characters
  302.                clockwise. The parameter specification is specified in
  303.                degrees.
  304.  
  305. DROPSHADOW     "Yes" or "no" depending if you want the characters to be
  306.                shadowed as though the sun were shining from the top left
  307.                corner of the page.
  308.  
  309. VARIABLESHADE  "yes" or "no".  Specifying "yes" will cause the characters
  310.                to be shaded in varying shades of gray with the darkest
  311.                portion of the character being the top and the lightest the
  312.                bottom.
  313.  
  314. FANCYPRINT     "yes" or "no".  Specifying "yes" will shadow the characters
  315.                in an attractive way.  This is borrowed from the Postscript
  316.                Tutorial and Cookbook by Adobe Systems and is illustrated
  317.                on Page 68 of that book.
  318.  
  319. HDRFONT        If header is specified, the user may indicate with this
  320.                parameter the exact name of the font to be used.  No
  321.                checking is performed on the fontname thus it must be
  322.                entered exactly as it is in the printers "dictionary".
  323.                This parameter may not be specified via the menu option, it
  324.                may only be specified either in the profile or on the
  325.                command line.
  326.  
  327. HDRSIZE        If a header is specified and a user font is specified with
  328.                the "hdrfont" option, then the size of the header font may
  329.                be specified with this parameter.
  330.  
  331. HEADER         Specifying "yes" to this parameter will cause a header to
  332.                be printed at the top of each page.  The header will
  333.                contain the name of the file being printed, it's creation
  334.                date and time, along with the date and time that the file
  335.                is being printed.
  336.  
  337.  
  338.  
  339. 2UP            (no parameter specified; if present the program will print
  340.                two pages in landscape mode on each physical page).  Other
  341.                than making the output landscape no other parameters are
  342.                affected, thus you may specify any font, whether it should
  343.                be outlined or shaded, etc.  However, the following
  344.                characteristics work well for 2up printing :
  345.  
  346.                               Font=Courier-Bold
  347.                               Size = 6
  348.                               LPI = 9
  349.  
  350.                All margins (top, bottom, and left) will continue to be
  351.                honored on each virtual page (i.e., the left and right
  352.                portions of the physical page.)
  353.  
  354. NUMBER         Specifying "yes" to this parameter will cause a four digit
  355.                sequential number to be printed at the beginning of each
  356.                line.
  357.  
  358. An example profile might look like:
  359.  
  360. EXAMPLE PROFILE
  361.  
  362.      ╔══════════════════════════════════╗
  363.      ║  font = Helvetica                ║
  364.      ║  size = 10                       ║
  365.      ║  top = 1.5                       ║
  366.      ║  bot = 3                         ║
  367.      ║  left = 1.5                      ║
  368.      ║  lpi = 6                         ║
  369.      ║  outline = yes                   ║
  370.      ║  shading = .5                    ║
  371.      ║  lw = .5                         ║
  372.      ║  *2up                            ║
  373.      ║  *rotate = 45                    ║
  374.      ║  orient = portrait               ║
  375.      ║  device = LPT3                   ║
  376.      ║  header = yes                    ║
  377.      ║  number = no                     ║
  378.      ╚══════════════════════════════════╝
  379.  
  380. Note:  The 2up and rotate options are shown coded as comments.  If, for
  381. some reason, you wanted these items to be actual parameters n the profile
  382. you would, of course, remove the asterisks.
  383.  
  384.  
  385. SPECIFYING THE FILE(S) TO BE PRINTED
  386.  
  387. Wildcard characters may be used to specify the name of the file(s) to be
  388. printed.  For example, if it is desired to print all files in the current
  389. directory whose extension is ".TXT", the file may be specified as:
  390.  
  391.          PSPRINT *.TXT
  392.  
  393.  
  394.  
  395. Parameters may be specified on the command line using the format:
  396.  
  397.          /keyword=operand
  398.  
  399. where the keywords used are the same as described above in the
  400. initialization file.  For example to override the initialization file with
  401. 8 lines per inch, with a Courier-Bold font, you would specify:
  402.  
  403.          PSPRINT  TEST.TXT  /LPI=8  /FONT=Courier-Bold
  404.  
  405. Note, if any command line options are speicified, the the first parameter
  406. must always be the name of the file to be printed.  If PSPRINT is invoked
  407. with no parameters at all the program will display help text and prompt for
  408. the name of the file to be printed.  When specifying fonts on the command
  409. line, or specifying the name of a downloaded font via the menu option, the
  410. exact spelling and case must be used as the font is stored in the directory
  411. within the printer.  In the example above, Courier-Bold must be specified
  412. exactly as shown, with the dash between the word courier and bold, and the
  413. first letter of each portion must be capitalized.  Another example might be
  414. "BrushScript" which must be specified exactly that way.  Neither
  415. "Brush-Script" nor "Brushscript" will work.
  416.  
  417.  
  418. SPECIFYING OPTIONS USING A MENU
  419.  
  420. By far, the easiest way to specify options is with the use of menus.  Menus
  421. are always displayed unless you invoke PSPRINT with the "/nomenu" option.
  422. If the following line is used to invoke PSPRINT, the menus will be
  423. displayed:
  424.  
  425.          PSPRINT TEST.TXT
  426.  
  427. However, the following line will bypass the menu selections:
  428.  
  429.          PSPRINT  TEST.TXT  /NOMENU
  430.  
  431. You may specify any other command line parameters in conjunction with the
  432. menu option.  The nomenu parameter may be specified in PSPRINT.INI if you
  433. never wanted the menu displayed.
  434.  
  435.  
  436. USING MENUS
  437.  
  438. The menus in PSPRINT follow the usual "Lotus-style" pull-down menus with
  439. one added twist.  As you move from one selection to another on the top
  440. menu, not only does a brief description of the options available appear
  441. below the choices, but a box appears that elaborates on the selections
  442. available for that menu item.  Some people find that the box popping up is
  443. a bit disconcerting and this function can be disabled from the menu choice
  444. in the File/Run selection by clicking the "FULL MENUS" option which will
  445. toggle OFF if it is on and ON if it is off.  Some of the menus are
  446. illustrated in the printed version (or the Postscript version) of the
  447. documentation file.
  448.  
  449.  
  450.  
  451. PARAMETER HIERARCHY
  452.  
  453. The hierarchy used when selecting options is as follows:
  454.  
  455.        Program Defaults
  456.                PSPRINT.INI initialization file
  457.                        Command line paramters
  458.                                Menu selected options
  459.  
  460. This means that any item specified via the menus will override any of the
  461. options specified via the command line or the profile.  Any parameters
  462. specified on the command line will override those specified in the profile.
  463.  
  464. If you have any comments, feedback, or suggestions please send them
  465. directly to Star Graphics at the address shown below.  Your input is
  466. encouraged and appreciated.
  467.  
  468. Thank you vor trying PSPRINT.  Remember, if you find PSPRINT
  469. useful, please send $35.00 to register the product to:
  470.  
  471.         Star Graphics
  472.         6904 Robin Willow Drive
  473.         Dallas, Texas 75248
  474.  
  475. Receipt of your registration fee will entitle you to a diskette containing
  476. the latest version as well as a printed copy of the documentation.
  477.  
  478.  
  479.  
  480.    ╔══════════════════════════════════════════════════════════════════════╗
  481.    ║                                                                      ║
  482.    ║                      REGISTRATION COUPON                             ║
  483.    ║                                                                      ║
  484.    ║  Name:    __________________________________________________         ║
  485.    ║                                                                      ║
  486.    ║  Company: __________________________________________________         ║
  487.    ║                                                                      ║
  488.    ║  Address: __________________________________________________         ║
  489.    ║                                                                      ║
  490.    ║  City, State, Zip:__________________________________________         ║
  491.    ║                                                                      ║
  492.    ║  Country: _________________________________________                  ║
  493.    ║                                                                      ║
  494.    ║                                                                      ║
  495.    ║  Where did you obtain your copy of PSPRINT?__________________        ║
  496.    ║                                                                      ║
  497.    ║  ____________________________________________________________        ║
  498.    ║                                                                      ║
  499.    ║                                                                      ║
  500.    ║  Are there any features that you would like to see added to PSPRINT? ║
  501.    ║                                                                      ║
  502.    ║  ___________________________________________________________________ ║
  503.    ║                                                                      ║
  504.    ║  ___________________________________________________________________ ║
  505.    ║                                                                      ║
  506.    ║                                                                      ║
  507.    ║  Any other comments would be appreciated. __________________________ ║
  508.    ║                                                                      ║
  509.    ║  ___________________________________________________________________ ║
  510.    ║                                                                      ║
  511.    ║  ___________________________________________________________________ ║
  512.    ║                                                                      ║
  513.    ║  Distribution disk size desired (3.5"-DD or 5 1/4"-HD)______________ ║
  514.    ║                                                                      ║
  515.    ║  Include your $25.00 registration fee and mail to:                   ║
  516.    ║                                                                      ║
  517.    ║            Star Graphics                                             ║
  518.    ║            6904 Robin Willow Drive                                   ║
  519.    ║            Dallas, Texas 75248                                       ║
  520.    ╚══════════════════════════════════════════════════════════════════════╝
  521.  
  522.